home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / network / wnbff16a.zip / WINBIFF.TXT < prev   
Text File  |  1993-07-22  |  7KB  |  168 lines
  1.  
  2. WinBiff 1.6a - (C) Copyright 1992-93, Paul A. Steckler
  3. ------------------------------------------------------
  4.  
  5. WinBiff is a Windows 3.x version of the well-known Un*x biff 
  6. program, designed for use in conjunction with mail delivery 
  7. programs such as UUPC/extended, Waffle, Pegasus, FSUUCP, and sendmail.
  8.  
  9.  
  10. INSTALLING WINBIFF
  11. ------------------
  12.  
  13. Copy the file WINBIFF.EXE to any convenient directory.
  14. Typically, users keep WINBIFF.EXE in a directory along with other
  15. small Windows utilities.
  16.  
  17. To configure WinBiff for your system, start the program, and
  18. select "Setup" from the system menu in the upper left window. In
  19. the dialog box which pops up, enter a suitable polling interval
  20. (how often WinBiff checks your mail file), a caption for the WinBiff 
  21. title bar, the full pathname of the file your mail delivery program 
  22. creates, the command to invoke your mail reader (including any 
  23. command-line arguments), and optionally, the name of a ".WAV" file to 
  24. play when mail is received.  
  25.  
  26. The minimum polling interval is 5 seconds.  If no caption is specified, 
  27. the mail file will be used.  You may use DOS wildcard characters ("*" 
  28. and "?") in the mail file specification.  Pegasus users should use 
  29. "*.CNM" in the mail file specification.  (Note for Waffle users: Waffle 
  30. creates two mailbox files, a text file with a ".F" extension, and an 
  31. index file with a ".I" extension.  Specify the ".F" file for WinBiff.)  
  32.  
  33. By clicking with the left mouse button in the appropriate 
  34. boxes, you may choose the additional options:
  35.  
  36.         o start the program minimized
  37.         o "autosize" the program window
  38.         o show mail headers
  39.         o reverse sort headers by order of arrival
  40.         o whether on startup to display kept mail
  41.  
  42. The "autosize" option tells WinBiff to display an icon when there
  43. is no mail, and to display a window (with or without headers)
  44. when mail is present.  The reverse sort option is inapplicable,
  45. and its checkbox disabled, unless the show headers option is
  46. selected.  If the "show kept mail" option is de-selected, 
  47. and your mail file(s) have not been modified since WinBiff was
  48. closed, mail will not be displayed.  
  49.  
  50. You can choose what sound WinBiff will make when new mail is
  51. received, by clicking on the appropriate radio button in the
  52. dialog box.  Choosing "Beep" uses the Windows "Default Beep"
  53. sound.  Choosing "Custom" plays the .WAV file given in the Sound file
  54. field.  The "Test" button allows you to play the sound file
  55. during setup.  (You must have appropriate hardware and/or drivers
  56. installed for this choice to work.  A speaker driver SPEAKER.DRV which
  57. provides adequate results without special hardware is available at many
  58. shareware sites, and is available from the author on request.)
  59.  
  60. For the mail file, mail reader, and sound file fields, clicking on an
  61. adjacent Browse button allows you to pick files from a Windows Common
  62. Dialog box.  The Browse buttons require the Windows 3.1 COMMDLG.DLL.
  63. If you are running Windows 3.0, and do not already have COMMDLG.DLL,
  64. you may obtain a copy at many shareware sites, from Microsoft,
  65. or from the author.
  66.  
  67. If you press the "Save" button, a WINBIFF.INI file is created,
  68. and the values you have given will be recalled when the program
  69. is started subsequently. The WINBIFF.INI file will be placed in
  70. the current directory.
  71.  
  72. You may run multiple copies of WinBiff to monitor multiple mailboxes.
  73. For each mailbox to be monitored, using mkdir, create a directory where
  74. a WINBIFF.INI will be stored.  Then, for each each mailbox, add an item
  75. to a folder in the Windows Program Manager, and specify one of the
  76. configuration directories just created as the "Working Directory".
  77. When you save your configuration information, it will be saved in
  78. the "home" directory for that mailbox.
  79.  
  80.  
  81. USING WINBIFF
  82. -------------
  83.  
  84. When WinBiff runs minimized, it displays either of two icons.
  85. One icon shows a mailbox with its flag down; the other shows
  86. the same mailbox with its flag raised, and the word "MAIL".
  87. WinBiff switches between these two icons depending on whether
  88. there is mail in the specified mail file.  The arrival of new
  89. mail causes the program to beep.
  90.  
  91. When WinBiff runs in a window, unless the show headers option has
  92. been selected, it displays bitmaps equivalent to the icons.  That
  93. is, there are two bitmaps, one for when there is no mail, and
  94. another for when there is.  If the show headers option has been
  95. selected, and there is mail, the "From:" and "Subject:" lines for
  96. up to 150 messages are displayed in the window. Scrollbars are
  97. provided, allowing scrolling through the headers. Choosing the
  98. reverse sort option displays the headers so that the
  99. latest-arriving message is at the top.
  100.  
  101. The user may force the appearance of the original, no-mail icon
  102. (or bitmap) by selecting "Clear" from the system menu.  
  103. If "Clear" is chosen, the menu item changes to "Show".  
  104. Choosing "Show" will re-display the mail bitmap or mail headers.
  105. If mail is pending, but not displayed on startup (because
  106. the "show kept mail" option is not selected), choosing
  107. "Show" will display the pending mail.
  108.  
  109. To invoke the mail reader, double-click with the
  110. right mouse button on the icon or window.  If the window is
  111. displayed, you may also double-click with the left mouse button
  112. or hit <RETURN>.  The reader is invoked whether or not you
  113. actually have mail pending.
  114.  
  115. When WinBiff is iconized or the "show headers" option is set, the
  116. caption reads "WinBiff (caption)"; it reads just "caption" if
  117. headers are disabled and running as a window -- this is so the
  118. title bar is of reasonable size.  WinBiff's window is resizable;
  119. the bitmaps remain reasonably proportioned regardless of size.
  120.  
  121.  
  122. BUGS/PROBLEMS
  123. -------------
  124.  
  125. If you play a .WAV file on the receipt of mail, use SPEAKER.DRV as your 
  126. sound driver, and disable interrupts during playback, a serial-port 
  127. communications program (such as UUPC's UUIO) may lose characters.  
  128. Normal operation of a single UUIO process should not be a problem, since 
  129. mail delivery occurs after all files have been transferred.
  130.  
  131.  
  132. REGISTRATION
  133. ------------
  134.  
  135. WinBiff is a shareware program.  If you use the program in a commercial
  136. setting, or non-commercially on a regular basis, please submit
  137. contributions ($10 suggested) to:
  138.  
  139.         Paul A. Steckler
  140.         48 Hawthorne Street
  141.         Somerville, MA  02144-2907
  142.  
  143. Users who submit $10 or more will receive updates as a uuencoded
  144. .ZIP file by e-mail.
  145.  
  146. You may freely distribute the WinBiff executable file as long as the
  147. executable file is not modified in any way, and as long as this document
  148. accompanies the executable.
  149.  
  150. Disclaimer:  You use WinBiff at your own risk.  All warranties expressed
  151. and implied are disclaimed.  Any damages resulting from the use
  152. of WinBiff shall not result in any liability.
  153.  
  154. E-mail correspondence concerning this program may be submitted to:
  155.  
  156.         winbiff@blimpy.ci.net
  157.  
  158. Users without ftp access may request a uuencoded .ZIP file of
  159. the latest version of WinBiff by sending a message to:
  160.  
  161.         winbiff-request@blimpy.ci.net
  162.  
  163.  
  164.  
  165. Paul A. Steckler
  166. July 19, 1993
  167.  
  168.